home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / RecordEval.3 < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tcl_RecordAndEval(3) Tcl Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tcl_RecordAndEval - save  command  on  history  list  before
  12.      evaluating
  13.  
  14. SYNOPSIS
  15.      #include <tcl.h>
  16.  
  17.      int
  18.      Tcl_RecordAndEval(_i_n_t_e_r_p, _c_m_d, _e_v_a_l)
  19.  
  20. ARGUMENTS
  21.      Tcl_Interp   *_i_n_t_e_r_p    (in)      Tcl interpreter  in  which
  22.                                        to evaluate command.
  23.  
  24.      char         *_c_m_d       (in)      Command  (or  sequence  of
  25.                                        commands) to execute.
  26.  
  27.      int          _e_v_a_l       (in)      0  means   evaluate   _c_m_d,
  28.                                        TCL_NO_EVAL  means  record
  29.                                        it but don't evaluate it.
  30. _________________________________________________________________
  31.  
  32.  
  33. DESCRIPTION
  34.      Tcl_RecordAndEval is invoked to record a command as an event
  35.      on  the history list and then execute it.  It returns a com-
  36.      pletion code such as TCL_OK just like Tcl_Eval and it leaves
  37.      information  in  _i_n_t_e_r_p->_r_e_s_u_l_t.  If you don't want the com-
  38.      mand recorded on the history list  then  you  should  invoke
  39.      Tcl_Eval    instead    of    Tcl_RecordAndEval.     Normally
  40.      Tcl_RecordAndEval is only  called  with  top-level  commands
  41.      typed  by the user, since the purpose of history is to allow
  42.      the user to re-issue recently-invoked commands.  If the _e_v_a_l
  43.      argument is TCL_NO_EVAL then the command is recorded without
  44.      being evaluated.
  45.  
  46.  
  47. KEYWORDS
  48.      command, event, execute, history, interpreter, record
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.